home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 23 / Amiga Format AFCD23 (Feb 1998, Issue 107).iso / -coverdisks- / subsdisk / subs.dms / subs / gui4cli.LZX / Gui4Cli / Docs / Changes next >
Text File  |  2010-06-12  |  8KB  |  222 lines
  1.  
  2.  
  3.    ******************** VERSION 3.3 CHANGES *******************
  4.  
  5.   Nothing much..
  6.  
  7.   This version was released because Version 3.2 had a bug in it's
  8.   INSTALL routine.
  9.  
  10.   - Fixed a small bug in the LVInsert command which didn't increase
  11.     the $$lv.tot count and did not make the inserted rec current.
  12.  
  13.   - Added a whole lot of new file type checking (by Brian Jones)
  14.     Most types should now be recognised. Also added 1-2 guis.
  15.  
  16.  
  17.    ******************** VERSION 3.2 CHANGES *******************
  18.  
  19.  
  20. --------------- CHANGES AFFECTING GUIS OF PREVIOUS VERSIONS:
  21.  
  22.   Only one change, which will not greatly affect your guis :
  23.  
  24.   Now a gui's variables are considered to be PRIVATE by default, 
  25.   i.e. without having to previously issue the VARPATH command.
  26.   It's more straight forward this way.
  27.  
  28.   If you have any problems, just add the global command: 
  29.   - VARPATH '*' - to your guis. 
  30.   If you still have problems you must trace down the variables you 
  31.   want to have as Global, and put a * in front of them.
  32.  
  33.  
  34. --------------- HELP:
  35.  
  36.   Now help for gadgets is available through the gadget modifier :
  37.   >  GADHELP 'This is some help text'
  38.  
  39.   To turn the help system on/off you can hit the HELP key, or give 
  40.   the command SET HELP ON|OFF
  41.  
  42.  
  43. --------------- NEW EVENTS:
  44.  
  45. - xPIPE  PIPE:FileName  ON|OFF
  46.   will launch a new process which will open and monitor a pipe: file
  47.   and will send you any output that any program redirects to it in
  48.   the form of lines of text via the internal variable $$PIPE.TXT
  49.   - SetGad now has a new keyword CLEAN, used *only* for pipes.
  50.  
  51.  
  52. --------------- NEW COMMANDS:
  53.  
  54. - xLVINSERT RecordNumber string
  55.   will insert the given string *before* the given record. 
  56.   RecordNumber of -1 means the CURRENT record. 
  57.  
  58. - BREAKTASK TaskName CDEF (signals) signals a task named TaskName
  59.   with a given combination of signals - like if you used the Amigados
  60.   break & status commands together. Usefull for stopping programs.
  61.  
  62. - SET DEEPTRANS ON|OFF - setting DEEPTRANS OFF will stop Gui4Cli from
  63.   translating variables within variables - this will last for one
  64.   execution cycle. This comes useful in the filetype checking routines
  65.   which are now much faster.
  66.  
  67. - PARTREDRAW GuiName L T W H - will redraw only part of the window.
  68.   Use this if you're just changing some gadgets in one area of the
  69.   window and do not want a full redraw. It's easier on the eyes..
  70.  
  71. - SETGADVALUES GuiName - will store the values of all the gadgets of
  72.   a gui into their respective variables. This is usefull at the 
  73.   start of a gui, when you have to set the default values of your
  74.   variables.
  75.  
  76.  
  77. ---------------- VISUAL EDITING IMPROVEMENTS:
  78.  
  79. - CONTROL-J while in GUI Visual Editing mode, will now clone the 
  80.   gadget in it's own window.
  81.  
  82. - A GRID is now available, which makes lining up the gadgets much
  83.   easier. By default the grid size is 1 which means "no grid".
  84.   You can set the grid size with "SET GRID 5" (5 is a good size..)
  85.  
  86. - Gui4Cli will now adjust the position of ghosted gadget you move 
  87.   around while editing, to keep it inside the window borders. This
  88.   does not effect inter-gui cloning which works as usual.
  89.  
  90. - Various small bugs were exterminated (see bug-fixes below).
  91.  
  92.  
  93. ---------------- TEXT IMPROVEMENTS:
  94.  
  95. - CTEXT last argument (the mask for underline|bold|italic) now works...
  96.   Also, it has 2 more digits :
  97.   Digit #4, is the color number of the "shade" which the letters will be 
  98.             shaded with, producing a 3D effect.
  99.   Digit #5, is the size of the shade (defaults to 1)
  100.   You need not declare these two.. 
  101.  
  102. - Also in CTEXT, if you give -1 as the background color, the background
  103.   will not be disturbed. Useful for writing over an Image background..
  104.  
  105. - CTEXT, WINFONT and GADFONT now also recognise the following :
  106.   - #MONO    specifying the default Monospace font, and
  107.   - #SCREEN  specifying the Screen font, which is usually proportional.
  108.   It is best to use these two in GUIs which you want to distribute.
  109.  
  110.  
  111. --------------- LISTVIEWS:
  112.  
  113. - COLORED, fancy text can now be seen in listviews! (only WB 3.0+)
  114.   Listviews will now interpret and render all the console sequences 
  115.   which set text color and mode (bold etc). See "Important Topics".
  116.   (also read this text with it..)
  117.  
  118. - A new type of listview "SHOW" which is exactly like "TXT", except 
  119.   that the selected choice will remain highlighted.
  120.  
  121.  
  122. --------------- DIRECTORY LISTVIEWS:
  123.  
  124. - DIR ListViews will now show you the directory sizes next to the
  125.   dir name, if you issue a LVAction ..SIZE.. command.
  126.  
  127.  
  128. --------------- EXTENDED VARIABLE NOTATION:
  129.  
  130. - NORMAL variables now have extended notation:
  131.  
  132.   - Private    GuiName/VarName[start][length]
  133.   - Globals    *VarName[start][length]
  134.  
  135.   Apart from the VarName bit, all other components are optional.
  136.   Read all about it in "Important Topics"
  137.  
  138.  
  139. --------------- NEW INTERNAL VARIABLES:
  140.  
  141. - $$WIN.PATH will tell you the path of the current or infoed gui.
  142.   (same as extract gui guipath var)
  143.  
  144. - $$GAD.VAR is the name of the variable that the given gadget will
  145.   store it's value in.
  146.  
  147. - $$G4C.DEFSCREEN - The screen name which all guis get (default = '*')
  148. - $$G4C.OUTPUT - The default console output spec
  149. - $$G4C.FILEPATTERN - The default ASL requester file pattern
  150. - $$G4C.EDITOR - The default editor name (c:Ed)
  151. - $$G4C.GUIPATTERN - The dafault gui extension (#?.gc - for the requester)
  152. - $$G4C.GUILOADDIR - The dir that the G4C load requester will open at
  153.  
  154.  
  155. --------------- ARGUMENTS FOR ROUTINES:
  156.  
  157. - New and powerfull improvement (read "GOSUB/GUILOAD" in the guide):
  158.  
  159.   Commands which call other events (like Guiload which calls xOnLoad,
  160.   or GoSub which calls a routine) can now take up to 6 arguments which 
  161.   are passed to the routine the given command calls, in the form of 
  162.   Internal variables $$ARG.0 to $$ARG.5. -OR- (if defined in the 
  163.   event's command line) automatically converted to variables.
  164.  
  165.   $$ARG.TOT contains the actual number of arguments passed. 
  166.  
  167. - Furthermore, RETURN can also now return from the routine or xONLOAD
  168.   etc, with up to 6 more arguments, which are passed back to the 
  169.   calling GoSub or GuiOpen etc as internal vars $$RET.0 to $$RET.5.
  170.  
  171.  
  172. --------------- SCREENS:
  173.  
  174. - Up to now, the screen name that Gui4Cli used if no Screen had
  175.   been declared for a gui was "Workbench". Now it's the "*" character
  176.   which means "The Front Most Screen". i.e. now, your guis will open
  177.   by default on the front most screen.
  178.  
  179. - This default screen name can be changed with :
  180.   SET  DEFSCREEN  Workbench   (or whatever..)
  181.   Note : This is *not* the same as the OS's default screen..
  182.  
  183.  
  184. --------------- BUG FIXES:
  185.  
  186. - Fixed redrawing of windows when being resized which sometimes
  187.   left trash at the bottom of the window.
  188.  
  189. - UNLOADIMAGE which did not seem to work in version 3.1, is actually
  190.   called FREEIMAGE. (yes.. I'm not perfect.. it was a big suprise to 
  191.   me too..)
  192.  
  193. - Fixed some bugs in $$lv.rec and LVSearch/LVFind commands.
  194.  
  195. - Fixed some bugs in GuiEdit. The Cyclers/radios will now save correctly.
  196.   ** HOWEVER ** if you add a cycler or radio (by cloning it) and save the 
  197.   gui, you'll have to reload it before you can edit it again, because
  198.   these gads add lines to the gui and Gui4Cli will think it's an error.
  199.   Also fixed some other stuff..
  200.  
  201. - Fixed SetWinTitle command which effected the titles of other windows.
  202.  
  203. - Added a version string for the c:version command.
  204.  
  205. - Fixed extract EXT which did not remove quotes
  206.  
  207. - Optimised command linking when loading file - Loading should now be
  208.   faster by a nano-pico-millisecond or two...
  209.  
  210. - Fixed a bug with the initial size of the resizable borders which 
  211.   showed up when using the VisualPrefs program (which changes the screen
  212.   structure border sizes).
  213.  
  214.                   -------
  215.  
  216.   History of previous versions donated to the National Museum of Modern
  217.   Art. They didn't want it either, so I printed it out, burned it and
  218.   danced Kartsilama on the ashes..
  219.   
  220.  
  221.  
  222.